Doc fixes for compile.el

* lisp/progmodes/compile.el (compilation-first-column)
(compilation-error-screen-columns): Doc fixes.
* etc/NEWS: Related markup.

diff --git a/etc/NEWS b/etc/NEWS
index f67cfd3e434443747ece8f60341a0d9d3173a55e..138689cff69fa61d201d976ffa27e8b9343d8808 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -672,6 +672,7 @@ on platforms that support it.  This calls your desktop's preferred browser.
 inserted by the compilation filter function, when calling
 compilation-filter-hook.
 
+---
 *** `compilation-error-screen-columns' and `compilation-first-column'
 are obeyed in the editing buffer.  So programming language modes can
 set them, whereas previously only the value in the *compilation* buffer

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 05fea1edfd0411cfe91388b1762c8881e149438d..2a0c716aee5fa433767fa15f11269ccc55d1bbf4 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,8 @@
 2012-02-09  Glenn Morris  <rgm@gnu.org>
 
+       * progmodes/compile.el (compilation-first-column)
+       (compilation-error-screen-columns): Doc fixes.
+
        * vc/log-view.el (log-view-toggle-entry-display):
        * vc/vc.el (vc-merge, vc-pull): Doc fixes.
 

diff --git a/lisp/progmodes/compile.el b/lisp/progmodes/compile.el
index d477569fb2d677e6df2c22e2c57c073bc56f28f1..6c48eee7f4b12e60188d23e831ac6f35c3941621 100644 (file)
--- a/lisp/progmodes/compile.el
+++ b/lisp/progmodes/compile.el
@@ -78,7 +78,10 @@ after `call-process' inserts the grep output into the buffer.")
 This is bound to a buffer position before running `compilation-filter-hook'.")
 
 (defvar compilation-first-column 1
-  "*This is how compilers number the first column, usually 1 or 0.")
+  "*This is how compilers number the first column, usually 1 or 0.
+If this is buffer-local in the destination buffer, Emacs obeys
+that value, otherwise it uses the value in the *compilation*
+buffer.  This enables a major-mode to specify its own value.")
 
 (defvar compilation-parse-errors-filename-function nil
   "Function to call to post-process filenames while parsing error messages.
@@ -547,7 +550,10 @@ Otherwise they are interpreted as character positions, with
 each character occupying one column.
 The default is to use screen columns, which requires that the compilation
 program and Emacs agree about the display width of the characters,
-especially the TAB character."
+especially the TAB character.
+If this is buffer-local in the destination buffer, Emacs obeys
+that value, otherwise it uses the value in the *compilation*
+buffer.  This enables a major-mode to specify its own value."
   :type 'boolean
   :group 'compilation
   :version "20.4")